]> dgit.raspbian.org Git - gnome-shell.git/commitdiff
Add docs and (transfer none) to st_widget_get_theme_node()
authorOwen W. Taylor <otaylor@fishsoup.net>
Wed, 7 Oct 2009 18:26:14 +0000 (14:26 -0400)
committerOwen W. Taylor <otaylor@fishsoup.net>
Wed, 7 Oct 2009 18:26:14 +0000 (14:26 -0400)
st_widget_get_theme_node() was missing the (transfer none)
GObject Introspection causing crashes. Add that and document the
function.

src/st/st-widget.c

index 02c57cc4451fef8bc6cd62a0abb74d6e9ee7c244..2570ac62c652f5e76e64e680ceebc295d3b3f87a 100644 (file)
@@ -699,6 +699,20 @@ get_root_theme_node (ClutterStage *stage)
   return st_theme_context_get_root_node (context);
 }
 
+/**
+ * st_widget_get_theme_node:
+ * @widget: a #StWidget
+ *
+ * Gets the theme node holding style information for the widget.
+ * The theme node is used to access standard and custom CSS
+ * properties of the widget.
+ *
+ * Return value: (transfer none): the theme node for the widget.
+ *   This is owned by the widget. When attributes of the widget
+ *   or the environment that affect the styling change (for example
+ *   the style_class property of the widget), it will be recreated,
+ *   and the ::style-changed signal will be emitted on the widget.
+ */
 StThemeNode *
 st_widget_get_theme_node (StWidget *widget)
 {